home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / strategy / vga_card.000 / vga_cardgames-1.3.1.tar / vga_cardgames / README < prev    next >
Text File  |  1995-03-06  |  8KB  |  240 lines
  1. =================
  2. Card Games v1.3.1
  3. =================
  4.  
  5. This package contains a collection of simple card games using a VGA
  6. mode (640x480x16) and mouse.
  7.  
  8.  
  9. ------------
  10. Requirements
  11. ------------
  12. * svgalib (tested with version 1.24).
  13. * An svgalib compatible mouse.
  14.  
  15. ------------
  16. Installation
  17. ------------
  18. * Edit the Makefile, setting/changing CARDSMOUSE, CARDSMOUSEDEFAULTRATE,
  19.   BINDIR, LIBDIR and PREFIX, if necessary.
  20.   - CARDSMOUSE should be set to use the mouse_ functions, rather than
  21.     vga_setmousesupport().  This allows console switching for svgalib
  22.     versions earlier than 1.20.  If problems are encountered with
  23.     console switching, undefine this.  You should not need to define
  24.     it if you are using svgalib 1.20 or later.
  25.   - CARDSMOUSEDEFAULTRATE allows the mouse sampling rate to be changed
  26.     from the default, if CARDSMOUSE is also defined.
  27.   - The PREFIX is to avoid clashes with other programs with the same
  28.     name (such as the X11 game spider).  I suggest using vga_ or nothing
  29.     as the prefix.
  30.   - USEGETPIXEL can be set to use the vga_getpixel() function instead of
  31.     maintaining a shadow copy of the screen.  Thus, it will result in less
  32.     memory being used.  For svgalib v1.24 and earlier this should not be
  33.     used, because it doesn't work properly.  Hopefully this will work in a
  34.     future version of svgalib.  If USEGETPIXEL is defined, screen redrawing
  35.     is not available.  This is probably not an issue for most people.
  36.     However, I'll look into this if/when vga_getpixel() works.
  37. * Type 'make'.
  38. * As root, type 'make install'.
  39.  
  40. ------
  41. Thanks
  42. ------
  43. * Harm Hanemaayer <hhanemaa@cs.ruu.nl>,
  44.   Michael Weller <eowmob@exp-math.uni-essen.de>,
  45.   and other contributors for svgalib.
  46. * Rob Malouf <malouf@csli.stanford.edu> for (unknowingly) contributing
  47.   the font from dvgt (a very nice dvi viewer).
  48. * Jacques Ge'linas <gelinas@cmr.ca> for reporting the problem of the
  49.   non-existent mouse and providing patches for klondike for cycling
  50.   the stock which prompted the 1.1 changes.
  51. * <hymowitz@midget.twoson.edu> for prompting the addition of the ability
  52.   to switch consoles.
  53. * Laszlo <root@light-house.gts.org> for reporting the mouse pointer
  54.   display bug and suggesting I use less CPU time and a better red.
  55.  
  56. -----
  57. Notes
  58. -----
  59. * In addition to the mouse, there are keyboard shortcuts for the grey
  60.   buttons presented on the right of the screen: n for New Game, r for
  61.   Restart, u for Undo, q for Quit.  These allow you to quit even if you
  62.   don't have a mouse.  As a bonus, the interrupt character (often ^C)
  63.   also works.
  64. * Console switching is enabled using the usual mechanism (Alt-Fn) if
  65.   the programs were compiled with CARDSMOUSE defined, or if svgalib 1.20
  66.   or later is used.
  67. * Screen redrawing is available using ^L.  This feature may be useful if
  68.   the screen gets corrupted as a result of console switching.
  69.  
  70. ----------
  71. Known Bugs
  72. ----------
  73. * The playing card images aren't very good.
  74. * The "Oh Hell!" computer players are pretty stupid.
  75.  
  76. ------
  77. Wanted
  78. ------
  79. Somebody to create good looking artwork for this game, particularly
  80. the playing cards.  For the cards, please restrict yourselves to a
  81. width of 53 pixels and the colours white, black, red, blue and
  82. yellow.  Send any image type (that the pbm tools know about), or my
  83. playing card format.
  84.  
  85. It has been suggested that I use the cards from xpat or xbmcards.
  86. I've only looked into this briefly, but the cards would have to be
  87. resized and I'm not sufficiently satisfied with the results without
  88. further editing.
  89.  
  90. ----------------------
  91. Potential Improvements
  92. ----------------------
  93. The following will invalidate compatibility with older versions of
  94. svgalib:
  95. * Investigate keyboard_ functions so we can use select() rather than
  96.   polling the keyboard/mouse (this would require at least svgalib
  97.   1.20, assuming it works).
  98.  
  99. --------
  100. Feedback
  101. --------
  102. All feedback should be sent to evan@cs.mu.oz.au.
  103.  
  104. ---------
  105. ChangeLog
  106. ---------
  107. 1.0    25 Apr 1994    First Linux version completed:
  108.             Oh Hell! v1.0, Spider v1.0, Klondike v1.0,
  109.             Solitaire v1.0
  110. 1.1     5 May 1994    Oh Hell! v1.1, Spider v1.1, Klondike v1.1,
  111.             Solitaire v1.1
  112. 1.2    27 Jun 1994    Oh Hell! v1.2, Spider v1.2, Klondike v1.2,
  113.             Solitaire v1.2
  114. 1.3    26 Feb 1995    Oh Hell! v1.3, Spider v1.3, Klondike v1.3,
  115.             Solitaire v1.3
  116. 1.3.1     6 Mar 1995    Oh Hell! v1.3, Spider v1.3, Klondike v1.3,
  117.             Solitaire v1.3
  118.  
  119. #######################################################################
  120.  
  121. ==========
  122. Game Notes
  123. ==========
  124.  
  125. --------
  126. Oh Hell!
  127. --------
  128.  
  129. The aim of Oh Hell! is to win exactly the number of tricks that you
  130. bid.
  131.  
  132. First bid the number of tricks you expect to win (using the
  133. appropriate grey button).  There is no restriction on the sum of all
  134. the bids (it's ok for it to be the total number of tricks).
  135.  
  136. The card in the middle of the table indicates the trump suit.  The
  137. last hand (with 13 cards) is played with no trumps.
  138.  
  139. If the bid is made, the player scores 10 + #tricks won.
  140.  
  141. ChangeLog:
  142. 1.0    25 Apr 1994    First Linux version completed
  143. 1.1     5 May 1994    Keyboard shortcuts for major buttons added
  144.             Minor code reorganization
  145. 1.2    27 Jun 1994    Console switching added
  146.             Font loading added
  147. 1.3    26 Feb 1995    Colours adjusted
  148.             Mouse pointer display bug fixed
  149.             Less CPU used waiting for user input
  150.             Added vga_getpixel() support to vga16.c
  151.             Added screen redrawing
  152.  
  153.  
  154. ------
  155. Spider
  156. ------
  157.  
  158. The standard solitaire game of spider, much like the X11 version.
  159.  
  160. The primary differences compared to the X11 version are the lack of
  161. hint and scoring functions, and the left button is used for
  162. "dragging" cards as well as selecting.
  163.  
  164. If the player clicks on a card, the game will try to decide where the
  165. card should go (if it can go anywhere).  If the player doesn't agree,
  166. the card must be "dragged" to its intended destination.
  167.  
  168. ChangeLog:
  169. 1.0    25 Apr 1994    First Linux version completed
  170. 1.1     5 May 1994    Keyboard shortcuts for buttons added
  171.             Minor code reorganization
  172. 1.2    27 Jun 1994    Console switching added
  173.             Font loading added
  174. 1.3    26 Feb 1995    Colours adjusted
  175.             Mouse pointer display bug fixed
  176.             Less CPU used waiting for user input
  177.             Added vga_getpixel() support to vga16.c
  178.             Added screen redrawing
  179.  
  180.  
  181. --------
  182. Klondike
  183. --------
  184.  
  185. The standard solitaire game of klondike.
  186.  
  187. By default, this version progresses through the stock one card at a
  188. time and only goes through the stock once.  
  189.  
  190. Using the command option -m N, it can be changed to progressing through 
  191. the stock N cards at a time, and going through the stock N times.  A 
  192. common way of playing klondike can be emulated with -m 3.
  193.  
  194. Using the command option -c, the stock will be gone through an
  195. infinite number of times.  Pressing the mouse button on the empty
  196. stock each time resets it.  Using this option and not -m is probably
  197. cheating.
  198.  
  199. ChangeLog:
  200. 1.0    25 Apr 1994    First Linux version completed
  201. 1.1     5 May 1994    Keyboard shortcuts for buttons added
  202.             Minor code reorganization
  203.             Added options -c and -m
  204. 1.2    27 Jun 1994    Console switching added
  205.             Font loading added
  206. 1.3    26 Feb 1995    Colours adjusted
  207.             Mouse pointer display bug fixed
  208.             Less CPU used waiting for user input
  209.             Added vga_getpixel() support to vga16.c
  210.             Added screen redrawing
  211.  
  212.  
  213. ---------
  214. Solitaire
  215. ---------
  216.  
  217. The first solitaire game I was ever taught.  I've never seen it
  218. described anywhere, so I don't know its name.  If anyone does know its
  219. name, please send me mail and tell me.
  220.  
  221. Unlike the previous two solitaire games, in this one a card may only
  222. be put on the card with the next highest rank in the same suit.
  223. However, any card which is face up may be moved.
  224.  
  225. Like klondike, only kings may be moved into empty columns.
  226.  
  227. The aim is to get the each suit into a single column, K down to A.
  228.  
  229. ChangeLog:
  230. 1.0    25 Apr 1994    First Linux version completed
  231. 1.1     5 May 1994    Keyboard shortcuts for buttons added
  232.             Minor code reorganization
  233. 1.2    27 Jun 1994    Console switching added
  234.             Font loading added
  235. 1.3    26 Feb 1995    Colours adjusted
  236.             Mouse pointer display bug fixed
  237.             Less CPU used waiting for user input
  238.             Added vga_getpixel() support to vga16.c
  239.             Added screen redrawing
  240.